home *** CD-ROM | disk | FTP | other *** search
/ Risc World 3 / Risc World 3.iso / SOFTWARE / ISSUE3 / PD / VICE / !ViceRsrc / !Help < prev    next >
Text File  |  2002-09-01  |  32KB  |  684 lines
  1. Vice 1.10 for RISC OS
  2. ====================
  3.  
  4.  
  5.  
  6.  
  7. For general information see the Vice documentation. This file only deals with
  8. differences / specialities in the RISC OS version.
  9.  
  10.  
  11.  
  12. RISC OS NEWS since 1.9
  13. ======================
  14.  
  15. There have been mostly internal changes between those releases, as there
  16. haven't been any new features in the emulation core and I don't see the
  17. need to change the way the existing features are handled. Internal changes
  18. mostly deal with updates in my WimpLib (Small-footprint LGPL C/C++ library
  19. providing the interface to RISC OS, also available from my Software pages),
  20. e.g. better sprite handling, a standard menu for text windows (allowing you
  21. to e.g. save or edit text). Other changes include support for chip-specific
  22. video caches.
  23. Also note that my email address changed to zarquon@t-online.de since I
  24. successfully finished my PhD thesis and consequently quit FORWISS last may.
  25.  
  26.  
  27.  
  28. RISC OS NEWS since 1.8
  29. ======================
  30.  
  31. - (Internal change: switched to GCC 2.95.4)
  32.  
  33. - Stereo SID option. Basically the driver for this already worked in 1.8,
  34.   I just hadn't tested it before the release. Note that if you use the
  35.   StereoSID Player you have to run Vice in NTSC mode!
  36.  
  37. - Due to the many new options introduced with PAL emulation, there is now
  38.   a separate video configuration window.
  39.  
  40. - In order to support PAL emulation, the low-level interface in Vice has
  41.   changed. In the old versions, a bitmap with the correct colours for the
  42.   current mode was created, whereas in the new version, the bitmap always
  43.   has the C64 colours. That means I had to move to (slower) OS_SpriteOp plots
  44.   rather than my old BPlot module. There are some cases where the BPlot
  45.   module can still be used: for non-PAL emulation canvases, in case the screen
  46.   depth is more than 8bpp or in full screen mode if the screen palette is set
  47.   (see video config window "Set Palette"). If you select "Use BPlot" in the
  48.   video config window, you can still use the BPlot module in these cases,
  49.   otherwise Vice will always use OS_SpriteOp.
  50.   In case you own a ViewFinder graphics card, Vice will probably run much
  51.   better if you always switch OFF "Use BPlot".
  52.  
  53. - PAL emulation: this probably requires some additional words, in particular
  54.   regarding scaling. PAL emulation really needs a 2x screen to be fully
  55.   operational; you can achieve this by ticking the PAL double box in the
  56.   video config window. Note that the resulting bitmap is NOT just the 1x
  57.   bitmap scaled up, which is also the reason why I handled scaling the way
  58.   I did: the toggle icon on the emu pane does the ``soft'' scaling, i.e.
  59.   it merely allows plotting the bitmap at twice its normal size. PAL double
  60.   allows calculating a bitmap at twice the size, and you can use the soft
  61.   scaling in addition, if you want to. That system may seem a bit confusing
  62.   at first (try juggling 3 scaling factors in your coordinate transformations
  63.   for confusing, buddy: eigen factors, soft scaling, PAL double), but if you
  64.   bear in mind that the toggle icon on the pane just displays the same thing
  65.   larger whereas PAL double does more, it is logical in a way.
  66.   Regarding the depth used for PAL emulation, you can select five options
  67.   here:
  68.   - off (disables it)
  69.   - auto (uses the depth of the current screen mode, but at least 8bpp)
  70.   - 8/16/32: use this depth regardless of the current screen mode
  71.   8bpp PAL emu has to compromise, so you should use either 16bpp or 32bpp
  72.   modes if you want the real thing -- and use a screen mode of the same depth
  73.   for display.
  74.   A word of warning on PAL emu, though: it's very expensive, especially in
  75.   double size mode, plus the high colour depth required and the additional
  76.   frame buffer really choke the life out of the pitifully little bandwidth
  77.   we have available on RISC OS. Unless a miracle happens and someone releases
  78.   new RISC OS hardware with a fast bus and about 1GHz of processing power,
  79.   PAL emulation is unusable for anything but making nice screenshots on
  80.   RISC OS, I'm afraid.
  81.  
  82. - In order to save some trouble there are different screen modes possible
  83.   for full screen emulation in normal, PAL and double size PAL mode
  84.   possible (see video config window).
  85.   
  86.  
  87.  
  88.  
  89. RISC OS NEWS since 1.7
  90. ======================
  91.  
  92. No visible ones, since I was very busy towards the end of last year and could
  93. just keep the port in sync. The new stuff like PAL emulation and GUI (plus
  94. testing) of stereo SIDs will follow in the next version.
  95.  
  96.  
  97.  
  98. RISC OS NEWS since 1.6
  99. ======================
  100.  
  101. - (Internal change: switched from GCC 2.7.2 to GCC 2.95.2)
  102. - (Internal change: DigitalRenderer now voice generator based or 16bit enabled)
  103. - Added support for GZIP-compressed image files (file type &f89 or /gz extension)
  104. - Clear/Load/Save fliplist files. Clear and save is obvious, using the fliplist
  105.   menu (note that you can't save an _empty_ fliplist). You can load a fliplist
  106.   by dragging the fliplist file (must have filetype Text) to the emulation pane;
  107.   the first image in the fliplist will be attached to drive 8 automatically.
  108. - Provided interactive help because the emulators have become rather complex and
  109.   many people will probably not be aware of what the buttons can do.
  110. - Made drive types 2040, 3040 and 4040 available from the drive config window.
  111. - Fixed cartridge detaching by selecting type None (this works now).
  112. - Finally fixed Auto refresh speed and made it the default for all emulators.
  113.   That means that the number of frames are reduced automatically down to a
  114.   minimum number if the emulator can't run at 100% and redraw every frame.
  115.   That means that games like Delta and Armalyte are pretty playable (if a bit
  116.   jittery) now. You can configure the maximum number of skipped frames in the
  117.   system configuration window. The default is 5 and choosing larger values
  118.   doesn't improve emulation speed much more, but the display gets very jerky.
  119.   You should always use odd values for the maximum (some games and demos have
  120.   things flashing every other frame which you won't see otherwise).
  121. - Added a log window with the log messages. People who know Vice on Unix will
  122.   be familiar with the log messages, others may be somewhat surprised at all
  123.   the stuff that's logged. The log messages help diagnosing problems, also for
  124.   normal users; for instance if the log message is ``VDriveCommand: ERR = 30,
  125.   SYNTAX ERROR ...'' you tried to use high-level drive emulation on a program
  126.   that requires true drive emulation turned on. The maximum number of lines
  127.   kept in memory is limited to 1024, so you don't have to worry about memory
  128.   consumption exploding during long sessions with Vice. In the unlikely case of
  129.   the new log window causing problems or if you want to disable them for some
  130.   other reason, you just have to add ``-logfile null:'' to the last line of
  131.   the emulated machine's !Run file (without the `` / '', of course). I'm sorry,
  132.   but logging is determined too early in the program to allow for GUI widgets
  133.   to configure them.
  134. - Automatically suspend emulation in lots of places like attaching images etc.
  135.   to avoid these operations screwing up emulation (especially sound when the
  136.   image is on CDROM).
  137. - Extended the DigitalRenderer module to support 16bit sound as provided on
  138.   RO 3.5 and newer; as a matter of fact the DigitalRenderer module saw a major
  139.   overhaul in this release, see !ViceRsrc.DocDRender if you're interested in
  140.   more details and/or want to use sound in an application of your own. By default
  141.   16bit sound is _off_ in order to minimize compatibility issues, but if you have
  142.   16bit sound hardware I recommend that you enable it because it sounds much
  143.   better and causes less problems with the painfully exact sync reSID needs,
  144.   although both of these issues are probably just consequences of emulating the
  145.   old 8bit system on the new 16bit one. You can enable it from the sound config
  146.   window. In case you experience problems with 16bit sound, please let me know.
  147. - Image contents work with normal directories too. Since we already have the
  148.   filer you might ask: what for? And verily I tell you: because it allows you
  149.   to autostart PRG files without having to type LOAD statements by double-
  150.   clicking. You open an image contents viewer by holding down shift while
  151.   dragging the directory to one of the drive icons.
  152. - Double-clicking on the title in an image contents window does LOAD"*",8,1
  153.   (except for normal directories).
  154. - The semantics of dragging PRG-files to the emu window have changed. Now the
  155.   PRGs are autostarted on all emulators. If you hold down shift when releasing
  156.   the drag, on the C64 the file is only loaded (this is the old behaviour).
  157. - Added keyboard-shortcuts for snapshots and screenshots. Note that these can
  158.   only be used after a valid shot was made using the normal GUI elements, otherwise
  159.   you'll get an error. The main reason for these keyboard shortcuts was to be
  160.   able to handle snapshots and screenshots in full screen mode. The keys are:
  161.   Print (save screenshot), ^F9 (save snapshot), ^F10 (load snapshot).
  162.  
  163.  
  164.  
  165. RISC OS NEWS since 1.5
  166. ======================
  167.  
  168. - Added read-only options for all drives (marked as RO in the drive configuration
  169.   window to keep space requirements low).
  170. - Dag Lem modified his reSID engine so the actual engine is run fewer times,
  171.   resulting in a substantial speedup. In addition I rewrote some remaining
  172.   sound-related FP code to fixpoint, resulting in another big speedup. reSID
  173.   is now usable under RISC OS :-)
  174. - Added VSID mode. The VSID player uses the C64-binary in a special mode and
  175.   allows playing SID files without burdening the emulation with video and
  176.   drive issues, therefore the !Vice64 binary must have been seen by the filer
  177.   for VSID to operate. If you have a SA RPC do use reSID since it sounds much
  178.   better.
  179. - Improved speed limit code: NTSC works now, plus disturbances have less effect.
  180. - Added some functionality to wimplib. Now the monitor window is limited to
  181.   around 4096 lines to save memory when you're doing long sessions (like an
  182.   xterm does).
  183. - Some minor changes to the DigitalRenderer module for improved stability.
  184.  
  185.  
  186.  
  187. RISC OS NEWS since 1.4
  188. ======================
  189.  
  190. After a long time of just keeping the source in sync with the other ports I
  191. added some new stuff for 1.5 again. I've been working on WimpLib a lot lately
  192. and added a text window that can be used for both displaying text and as a
  193. command line widget so I could finally integrate the monitor better. In order
  194. to compile Vice you now need WimpLib 0.10 or newer.
  195.  
  196. - Replaced the monitor with a (multitasking) text widget. That means opening
  197.   the monitor does no longer freeze the entire desktop, apart from that you
  198.   get scrollbars and all the other niceties of a real window. While the monitor
  199.   is open the emulator is paused and you can't unpause it except for closing
  200.   the monitor again. This makes sure that there can be no reentrancy into the
  201.   monitor and is in fact the only system which was totally compatible with
  202.   Vice's internal use of the monitor (e.g. opening the monitor after a JAM code).
  203.   But nothing is modal, and that's the main issue here.
  204.   I know, most people won't ever use the monitor, but this is something I've
  205.   wanted to add for ages. Note that the monitor window can't be closed while
  206.   the monitor is outputting stuff, but the close request will be recorded and
  207.   executed as soon as the output is finished.
  208. - The other text windows (license, warranty, contrib) are now displayed with
  209.   the new WimpLib class as well and can be open concurrently (also you can
  210.   now navigate through them using the keyboard, but they're read-only).
  211. - Split drive window into (disk) drives and tape.
  212. - Resetting the emulator with double sized window now works correctly.
  213. - Fixed auto-attach of images on startup (interface must have changed somewhere
  214.   on the line).
  215. - Added FlipList support. This allows you to keep certain disk images in a
  216.   sort of hotlist for quick access. The Fliplist menu is accessible from the
  217.   emulation window menu and allows you to add the current disk image to the
  218.   fliplist, remove the current disk image from the fliplist, attach the next
  219.   and previous image in the fliplist. There's also a submenu that allows
  220.   direct access to all images in the fliplist; since this menu is also mirrored
  221.   somewhere there's also a detach entry to detach the currently active image.
  222.   You can also use PageUp / PageDown to walk through the fliplist which is
  223.   very handy for full screen mode.
  224.   Note that the fliplist is only available for drive 8!
  225. - The menu containing all the fliplist images is now also available by clicking
  226.   menu over the drive 8 icons on the emu pane.
  227. - The currently selected drive image is now displayed in the emulation window
  228.   title.
  229. - Added a window to create a new, empty disc image. It's accessible from the
  230.   icon bar menu.
  231. - Thanks to a wimplib extension almost all menus are indirected now. That means
  232.   that the menu text can become considerably longer than the 12 characters
  233.   possible so far. ATM I set the limit to 32 which should be fine for now.
  234. - Added a new sound device ``VIDC Sync'' (for synchronous VIDC). The old code
  235.   was running the sound as an asynchronous thread which has the advantage of
  236.   having very good latency characteristics, but unfortunately doesn't integrate
  237.   well with the way Vice handles complex sounds (e.g. samples) and issues like
  238.   oversampling internally. The synchronous device can handle these; the only
  239.   problem is that emulating sound samples as exact as Vice does, the performance
  240.   usually drops to 50% on my StrongARM RiscPC, so we'll have to wait for much
  241.   faster machines until it becomes really worthwhile...
  242.   In the meantime: as long as you're using ``simple'' sound, stick with the old
  243.   asynchronous device, if you want to listen to samples or use oversampling, use
  244.   the new synchronous one.
  245.   Note this also required a big update of the DigitalRenderer module.
  246. - Added screenshot functionality for saving sprites. The Unix version also allows
  247.   BMP and PNG but I figured we don't want BMP on RISC OS and we don't want about
  248.   100kB of libpng and libz linked into each emulator, so it's sprites only for us.
  249. - C64: files named "*/PRG" are now treated like ones with file type &64, i.e.
  250.   you can drag them into the emu window to load native C64 files.
  251.  
  252.  
  253.  
  254. RISC OS NEWS since 1.1
  255. ======================
  256.  
  257. Basically I kept the port in sync, i.e. added icons for new resources and so on.
  258. My main contribution to 1.2 was a restructuring of the drive emulation code which
  259. now uses shared code and private data sections for both drives. That cut about
  260. 150kB off each executable and made the true drive emulation a little faster on
  261. RISC processors.
  262.  
  263.  
  264.  
  265. RISC OS NEWS since 1.0.0.1
  266. ==========================
  267.  
  268. - Fixed bug concerning pause when the joystick window is open.
  269. - Optionally display status line in full screen mode (toggle with F9)
  270. - Support for multiple emulation windows; currently used by Vice128 (see below).
  271. - Support for keyboard configuration files (see below)
  272. - Message windows for License, Warranty and Contributors, available from icon
  273.   bar menu.
  274.  
  275.  
  276.  
  277.  
  278.  
  279. RISC OS NEWS since 0.16.1.0
  280. ===========================
  281.  
  282. - Sound code more stable.
  283. - Added freeze menu entry for modules like Action Replay.
  284. - ROMSet support via ROMSet Archives (see System window).
  285. - Imagecontents added: drag an image file (D64, T64, ...) to one of the drive
  286.   icons or the drive paths while holding down shift and instead of attaching the
  287.   image file a directory viewer will appear -- unless an error occurred. Also
  288.   since RISC OS doesn't allow more than one open on a file that has been opened
  289.   with write access you can't use this mechanism on an image that has already
  290.   been attached. Double-click on an item to load it into the emulated machine.
  291. - Option full screen mode operation (see below).
  292. - Lots of small bugs and features.
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299. Overview:
  300. =========
  301.  
  302. 1) What is it?
  303.    Vice is a collection of emulators covering 5 CBM machines, the C64, the C128,
  304.    the VIC20, the PET series and the CBM2 series.
  305.  
  306. 2) Memory requirements: Huge.
  307.    It's not possible to run any of these emulators on a 4MB machine. It's an
  308.    extremely close shave on an 8MB machine if you can get around 5-6MB free,
  309.    depending on which emulator you want to run. You should have more.
  310.  
  311. 3) CPU requirements: Huge.
  312.    Vice is cycle-exact, so if you compare it to Frodo you have to compare it
  313.    to FrodoSC and relative to that Vice is very fast. That doesn't change the
  314.    fact that you won't have much fun running Vice if you don't have a StrongARM.
  315.  
  316. 4) Concluding:
  317.    Vice is only recommended on StrongARM RiscPCs with 16MB or more.
  318.  
  319.  
  320.  
  321.  
  322. Running Vice:
  323. =============
  324.  
  325. Just double-click on the Vice-machine's filer-icon and it will install an icon
  326. on the icon bar and open the emulation window. Make sure !ViceRsrc can be
  327. written to if you want to save your Vice settings. The settings for each
  328. emulator will be stored in !ViceRsrc.<machine-name>.vicerc.
  329.  
  330. IMPORTANT NOTE: Do not terminate any of the emulators by force using ALT BREAK
  331. or something similar while sound (meaning the VIDC sound device) is active.
  332. While this is no problem when (VIDC) sound emulation is off this will in all
  333. likelyhood kill another one of your applications if it's on.
  334.  
  335.  
  336.  
  337.  
  338. Troubleshooting:
  339. ================
  340.  
  341. If nothing happens after the double-click the reason is probably 1) not enough
  342. memory or 2) !ViceRsrc has been moved so Vice$Path, the central variable pointing
  343. to the shared resources for each emulator, is no longer valid. In that case just
  344. double-click on !ViceRsrc and all necessary information will be updated.
  345.  
  346. If one of the emulators (not an emulated program!) should crash with sound
  347. emulation enabled you'll keep hearing the last sample buffer and no other
  348. program can use sound anymore. To remedy that you have to issue ``*DRenderOff''
  349. at the CLI.
  350.  
  351.  
  352.  
  353.  
  354. Vice configuration:
  355. ===================
  356.  
  357. There are a sh**load of configurations for each Vice. Check the general docs
  358. for a description of what everything does. You won't need many of those in
  359. everyday use.
  360. A lot of the configurations are in the form of menus. I didn't put descriptive
  361. labels next to those menus since that'd take up too much space. If you want
  362. to know what a menu group does just open the menu and check the title. The
  363. only menus that need a little extra explanation are probably the ones consisting
  364. of menu icon + descriptive icon + value icon (e.g. ``DOS Name'' and ``Cartridge''
  365. in the System configuration window). In the case of ``DOS Name'' the menu
  366. selects the drive type whose ROM name should be displayed (and made editable)
  367. in the writable icon, in the case of ``Cartridge'' the menu selects the type
  368. of the cartridge file in the value icon.
  369. Most configurations take immediate effect. Changes to writable icons only take
  370. effect after pressing <Return>. Some changes only take effect when Vice is
  371. restarted or the configurations are reloaded, however. Among those are the
  372. names for the various system resources like ROMs or palette files, all of which
  373. are found in the Configure->System window.
  374.  
  375.  
  376.  
  377. RISC OS specifics:
  378. ==================
  379.  
  380. System and Video window:
  381. ------------------------
  382.  
  383. Auto Pause:    automatically pause the emulator when the emulator window is
  384.         closed.
  385. Poll cs:    Minimum number of centiseconds between polls. Increase the
  386.         value to make Vice faster but the desktop less responsive.
  387. Speed cs:    Evaluate the emulation speed with this frequency.
  388. Sound cs:    Poll the sound hardware with this frequency. This value should
  389.         always be smaller than the configured sound buffer size. Using
  390.         a value of 0 defaults to half the buffer size.
  391.  
  392. ROMsets:    These are handled via ROMset archives (*/vra). The menu to the
  393.         left lets you choose one of the ROMsets currently available,
  394.         the one to the right lets you edit them. Create: add the current
  395.         ROM configuration to the ROMsets (give it a name first). Delete:
  396.         delete the currently selected ROMset. Save: save the currently
  397.         selected ROMset (not all of them). Dump: save entire ROMset
  398.         archive as ``romset/vra'' to the current machine's folder in
  399.         !ViceRsrc. Clear: remove all ROMsets, emptying the archive.
  400.         Restore: reload the ``romset/vra''-File mentioned above.
  401.         You can add a romset archive file to your current archive by
  402.         dragging this file (named */vra) to the System & Video window.
  403.  
  404.  
  405.  
  406. Pane icons:
  407. -----------
  408.  
  409. At the top are the 4 icons for each of the possible 4 disk drives. Immediately
  410. below that (initially blank) is an icon that'll display the current halftrack
  411. for drive 8 or 9 when in True Drive Emulation mode. You can toggle the drive
  412. whose halftrack you want to see by clicking on this icon. Below that icon is
  413. the Pause/Resume icon which should be self-explanatory. The Reset-icon will
  414. reset the emulated machine; click with select for a soft reset, adjust for a
  415. hard reset (which will also clear memory). The icon at the bottom can be used
  416. for toggling the size of the emulation window.
  417. In contrast to other platforms the drive LEDs also work when not in True Drive
  418. Emulation mode.
  419.  
  420.  
  421.  
  422. Multiple emulator windows:
  423. --------------------------
  424.  
  425. You can have multiple emulator windows for a machine (ATM C128 only). In this
  426. case only one of the windows will have a pane attached to it (this is the
  427. ''active emulator window'') and you can use the pane to toggle its size. You
  428. can transfer the pane to another window by either pressing F10 or using the menu
  429. entry ``MovePane'' in the emulator menu. In full screen mode you can use F10 to
  430. select the emulation window you want to display.
  431. Opening & closing: clicking select on the icon bar icon will always affect
  432. the last active emulator window, i.e. the one with the pane will be either
  433. opened or raised. You can open the other emulator windows by moving the pane
  434. (i.e. F10 or menu).
  435. Note: the 40/80 key of a C128's keyboard is ``emulated'' in the C128 config
  436. window.
  437.  
  438.  
  439.  
  440.  
  441.  
  442. Data IO:
  443. ========
  444.  
  445. On RISC OS we use drag and drop, so forget all references to file selection
  446. dialogue boxes and similar bullshit.
  447.  
  448. Attaching disk images / directories to drives:
  449. Drag the directory or disk image icon to the drive's LED on the EmuWindow's
  450. pane or the corresponding writable path icon in the Configure->Drives window.
  451. Disk images should be typed &164 (D64Image). If everything went well the
  452. writable path icon will be updated to show the new path afterwards, otherwise
  453. it'll remain unchanged (for instance when trying to attach a disk image to a
  454. drive that has drive type ``none'').
  455.  
  456. Selecting the files for RS232/Printer/Sound devices:
  457. The groups {OK-Button, writable path icon, draggable sprite} in the corresponding
  458. Configuration windows behave like in a Save As box.
  459.  
  460. Saving snapshots:
  461. Open snapshot savebox via the emulator window's menu. From then on it's exactly
  462. like a standard savebox. Note that when making a snapshot the emulator will
  463. run for a little more until it's ready. So even though you've got the emulator
  464. paused it'll progress a little -- this can't be helped.
  465.  
  466. Loading snapshots:
  467. Drag snapshot file icon to EmuWindow. The file must be typed ``Data'' (which
  468. it is by default) and of course be for the correct (virtual) machine.
  469.  
  470. Loading files directly into Vice64:
  471. Files typed &64 are interpreted as raw C64 files with the load-address in the
  472. first two bytes. These files can be loaded into Vice64 (not the other Vices!)
  473. by dragging them to the emulation window. This has the same effect as if you
  474. had loaded the file using ``LOAD "file",8,1'' from the emulator, except it's
  475. a lot faster and you don't have to worry about overwriting the IO area at
  476. $D000 for long files.
  477.  
  478.  
  479. Joystick configurations:
  480. ------------------------
  481.  
  482. Each joystick port can be mapped to 5 ``devices'': None (inactive), two sets
  483. of keys for emulation or two real (Acorn-compatible) joysticks. You can edit
  484. the keys thus: 1) make sure the Joystick-configuration window has the input
  485. focus by clicking inside it. 2) place the mouse pointer over the icon for
  486. the direction you wish to change and press the key you want to map to this
  487. direction. You may have to hold the key depressed for a while before it's
  488. recognized. You can also use keys like shift/ctrl/alt here.
  489.  
  490.  
  491. Keyboard shortcuts:
  492. -------------------
  493.  
  494. F5:   Toggle sound
  495. F6:   Activate monitor
  496. F7:   Restore-key (usually only has effect in combination with RUN/STOP=Escape)
  497. F8:   Reset emulator
  498. F9:   Toggle emu pane
  499. F10:  move pane to next emulation window (has effect on C128 only)
  500. F12:  (when in full screen mode) Return to desktop
  501. Print: Save screenshot to same path as last one (doesn't work for 1st save)
  502. ^F9:   Save snapshot to same path as last one (ditto)
  503. ^F10:  Load snapshot from last path (ditto)
  504. num/: Toggle True Drive Emulation. This will grey out drive icons 10 and 11.
  505. Copy: Toggle pause
  506. ScrollLock: When active, Vice goes into single tasking mode. This is 1) a
  507.       bit faster and 2) ensures continuous sound playback.
  508.  
  509.  
  510. Languages:
  511. ----------
  512.  
  513. The frontend is language-independent. All you have to do is provide a
  514. file containing the label --> text translations and set up the variable
  515. <Vice$Messages> to point to this file before startup. The english version
  516. can be found at Vice:Messages.
  517. This doesn't affect messages generated by the cross-platform Vice code itself,
  518. however, which will remain english. You'll have to complain to the Vice core
  519. team if you want that changed ;-).
  520.  
  521.  
  522.  
  523. Full Screen Mode:
  524. -----------------
  525.  
  526. You can now also run Vice in full screen mode, i.e. single tasking outside
  527. the WIMP environment. You can enter full screen mode using the icon bar
  528. menu and leave it again by pressing F12.
  529. The screen mode to use is very dependent on your computer and the machine
  530. emulated by Vice; therefore the mode is user-definable. The screen mode is
  531. described by a string of the form ``mode:resx,resy,lddepth'' (no spaces;
  532. lddepth is log2 of the depth, i.e. 2 for 4bpp, 3 for 8bpp, 4 for 16bpp, ...),
  533. to accomodate both new and old style mode selection. If you're running
  534. Vice on a RiscPC the second part of the mode descriptor string (resx,resy,lddepth)
  535. will be used, otherwise it's the mode number. By default ``28:640,480,3''
  536. is used because it's a standard mode and big enough to display all emulators;
  537. but it's certainly not ideal for all emulators, so have a play yourself.
  538. Also, if ``SetPalette'' is configured on, the screen mode has <= 8bpp and
  539. can display enough colours for the emulated machine, the palette will be
  540. reprogrammed, so when using a 4bpp mode with !Vice64 you'll get exact colours.
  541. Depth issues: internally Vice uses 8bpp for the display. On older machines
  542. it'll be more efficient to use an 8bpp mode because it minimizes computational
  543. overhead. On a StrongARM RiscPC, OTOH, you'll be better off using a mode with
  544. less colours (e.g. 4bpp for !Vice64) because that'll require less bandwidth.
  545. Since the palette can be reprogrammed there's no reason whatsoever to use
  546. a mode with more than 8bpp unless you think Vice is running too fast.
  547. You can edit the full screen mode string in the system configuration window.
  548. As far as configurations in full screen mode go: there are none. Neither can
  549. you attach any images and so on, only the keyboard-shortcuts still work. And
  550. I definitely won't re-program all the stuff that's available in the multi-
  551. tasking version for the fullscreen version.
  552.  
  553.  
  554.  
  555.  
  556.  
  557. Keyboard configuration files:
  558. -----------------------------
  559.  
  560. This is a new feature (wasn't available on RISC OS in Vice 1.0.0.1 yet). It
  561. allows you to change the keyboard mapping from your RISC OS computer to the
  562. keys of the emulated machine. The files used by the Unix-Version of Vice
  563. are unusable for this, therefore I made a new format. The RISC OS keyboard
  564. mapping files have the name RO*/vkm in the corresponding machine's sub-
  565. directory in !ViceRsrc (e.g. !ViceRsrc.C64.ROdflt/vkm). You have to edit
  566. these files (it says they're for RISC OS in the first line), not the ones
  567. for Unix.
  568. Hacking these files is quite low-level and thus not for the faint-hearted.
  569. On the RISC OS side you have to deal with _internal_ key-numbers which
  570. have nothing to do with ASCII. On the emulated machine's side these keys
  571. have to be mapped to row/column indices (see the Vice documentation for
  572. keyboard layouts).
  573. A line of this file has the format
  574.  
  575. intkey row col [s [srow scol [s]]] ["keystr"]
  576.  
  577. - intkey is the internal key number.
  578. - row, col are the row and column of the keyboard matrix of the emulated
  579.   machine. Use 15 for both to disable the key.
  580. - if row/col are followed by an 's' this means that a pressed shift-key
  581.   should also be emulated (e.g. for cursor left which is shift+cursor right
  582.   on a real C64).
  583. - if this is followed by another pair of numbers these are interpreted as
  584.   mappings for this key if the shift key is pressed.
  585. - at the end of each line is an optional string-representation of this key
  586.   in double quotes (valid for an english keyboard).
  587.  
  588. The mapping for shifted keys will probably need additional explanation:
  589. you DON'T have to (and shouldn't) define anything here if it's a trivial
  590. shifting, e.g. a+shift --> a+shift (the default keyboard mappings don't
  591. have any shifted mappings defined!). It should be used if the shifted key
  592. doesn't obey the mapping <base key> + shift --> <base key> + shift, e.g.
  593. mapping the asterisk (shift + '8' on an english keyboard) to the asterisk
  594. on a C64 (an unshifted key which is located where the ']' is on an english
  595. keyboard). For this example the mapping of the key '8' (internal key number
  596. 21) for a C64 would look like this:
  597.  
  598. 21 3 3 6 1
  599.  
  600. As a general rule of thumb: don't screw around with this file and make a
  601. backup copy before you do. It should also be noted that the more entries
  602. you define in the shifted keymap and the more 's'-flags you use the more
  603. likely problems arise (especially for games where a faithful mapping might
  604. be required). Imagine for instance a program that uses shift and '*' for
  605. two operations and you mapped the RISC OS '*' ( = shift + '8') to the '*'.
  606. You could never use both operations at the same time which can be a real
  607. nuisance if e.g. one of those operations is ``run'' and the other is
  608. ``fire''. You should therefore always strife to minimize both shifted
  609. keymaps and 's'-flags. The default mappings don't define any shifted keymaps
  610. and only 3 's'-flags, for instance. Also take care that you don't use keys
  611. that have a special meaning for Vice, e.g. F5-F10 etc.
  612. It's a dirty job but at some point I had to to it... ;-).
  613.  
  614. I didn't bother to make the filenames configurable; they're ROdflt/vkm
  615. for all emulators except for PET where they're RObusi/vkm (for business
  616. layout) and ROgrph/vkm (for graphic layout). Deleting these files will
  617. run Vice with the default keymap. You can load a keymap at run-time by
  618. dragging the file to the Kbd-icons in the System configuration window.
  619. One of these icons also opens a menu from where you can save the currently
  620. active keyboard mappings to a file.
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628. Misc:
  629. -----
  630.  
  631. - When turning on true drive emulation or dealing with snapshots, sound is
  632.   suspended for a short time. This is not a bug, it has to be done.
  633. - The default sound buffer size of 0.35s is only recommended when playing
  634.   music. If you're doing anything interactive you should use a lower value,
  635.   no higher than 0.1s.
  636. - Attaching compressed images (disk/ROM/...) is not supported on RISC OS.
  637.   Well, we have image filing systems for that.
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644. Support Programs:
  645. =================
  646.  
  647. c1541 and petcat are inside the !ViceRsrc directory and can be run using
  648. vice:c1541 / vice:petcat. For a description of both check the general Vice
  649. documentation. I didn't provide hacks to run either from one of the emulators,
  650. though.
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658. Thanks:
  659. =======
  660.  
  661. - Richard Atterer (atterer@informatik.tu-muenchen.de) for creating a set of
  662.   very nice looking icons.
  663.  
  664. - Stefan Bellon (bellonsn@trick.informatik.uni-stuttgart.de) for repeatedly
  665.   compiling the CPU-files with optimization for me (some of those need over
  666.   40MB).
  667.  
  668. - Richard Atterer, Stefan Bellon, Michael Kübel (Kuemmel@studbox.uni-stuttgart.de)
  669.   for beta-testing.
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676. Ported by:
  677. ==========
  678.  
  679. Dr. Andreas Dehmel
  680. Am Schorn 18
  681. 82327 Tutzing
  682. Germany
  683. zarquon@t-online.de
  684.